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Welcome to Issue 2 of The MagPi, a community led magazine Keeping you up to date with all things 
Raspberry Pi. 


What a month it has been following the release of Issue 1! The interest we received has astounded us, 
with over 100,000 views by readers as far apart as the US to New Zealand and Russia to South 
America. We have had positive reviews from the BBC's Rory Cellan-Jones, the Wall Street Journal Tech 
and many others. Thank you all for your kind words of support and constructive comments. 


Following the release of Issue 1, some of our readers soon highlighted an error in the logo for JavaScript. 
We hope that this has not caused too much confusion and 

wish to clarify that the official logo for JavaScript is as follows: 
Thank you for drawing this to our attention. 


In this issue of the MagPi we return to the Python Pit to give you more tasty tutorials and tips whilst 
also introducing you to our brand new section, the Command Line Clinic. The Scratch Patch will be 
returning in Issue 3. We invite you into the world of interfacing, how to install an Operating System on 
an SD card and setting up the basics on your Raspberry Pi. There is also more on building the skutter 
robotic arm. If this wasn't enough, we thought we would treat you to a double page spread dissecting 


the Pi and much, much more. 

Before drawing this editorial to an end, I would like to take this opportunity to thank not only the 
Raspberry Pi Foundation for warmly welcoming us, but also to the MagPi team and all of its 
contributors for their continual hard work,and dedication to producing the magazine. 


‘We hope you continue to enjoy reading the MagPi and that it inspires you to get programming. 


Ash Stone 
Chief Editor of The MagPi 


LITTLE BUNDLES OF JOY 


The first orders of Raspberry Pi 
computers are now reaching the 
homes of excited owners. Lucky 
‘Steven from Derbyshire’ managed 
to snare two of them! 


Steven a.k.a. ‘veryevil' ordered from both 
Farnell and RS Components, and both orders 
have been processed. He has loaned one of 
his Pi's to a friend to work on 'Debian Hard 


Floating Point’. 


We have had many reports of other people 
starting to get their orders through. Our very 
own Meltwater now has his - The first of the 
MagPi Team to get his hands on one. This 
means we can start to run our own tests and 


experiments. 
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With the computers now in the hands of 
developers and the public, work is rapidly 
progressing. Add-on boards, ported games, 


and a phase of software testing has begun. 


You can expect there to be a flurry of new 
discoveries over the next few months. The 


MagPi will be there to keep you up to speed. 


Article by Jaseman 


PvUSetup 


There are many ways to setup the 
Raspberry Pi, depending on your 
needs and the peripherals you wish 
to use. 
Power 
The Raspberry Pi uses a micro 7 


USB power connector, as used 
by most modern smart phones. 


Micro USB connector 


The PSU (power supply unit) must supply 5V 
and at least 700mA (0.7A). 
Most plug in PSUs will be 


LPS AC/DC ADAPTOR 
x Hz 0.4A 


marked with their rating. HP TouchPad PSU 
This one will supply up to 2000mA (2.0A). 
USB 


The USB ports on the Raspberry Pi are only 
suited to low power devices (~100mA). 
Anything which uses too much current will not 
function correctly. Therefore, a powered USB 
hub (a USB hub with it's own PSU) is 
recommended, so that all devices will have 
enough power to operate correctly. 


Control 

Direct control of the Raspberry Pi will be 
through a mouse and keyboard. Use a 
standard USB mouse and keyboard or a 
wireless set using a USB RF a 
dongle. A PS2 keyboard and 
mouse will need a USB “‘ coitech RF Dongle 
adapter. 

It should be possible to use a Bluetooth 
keyboard and mouse using a low cost 
Bluetooth USB adaptor, but some “@ 
additional setup will be required. . va 


Bluetooth Dongle 


Display 


Your display will depend on 
what you have available to 
you. Most digital TVs will have 
an HDMI connection and 
newer LCD monitors will often 


HDMI to DVI AdaptoriCables: as 
Ensure your DVI connections match as there are 
several types. Many monitors will only support DVI-D 
(bottorn) with no holes for the four analogue pins DVI- “— 
| AYDVI-l (top), so an DVI-D adaptor is 
recommended (this will also fit monitors 
with DVI-A/DVI-| support). 


RCA VIDEO AUDIO LEDS USB LAN 


256MB RAM 
CPU & GPU 


| Tip: Although most connections can be made while the 
| Raspberry Pi is powered on, it is recommended that the 
| display and the SD card are only ever connected or 

| disconnected when you have removed the power first. 


| | 
have DVI connections (you will need to use an 
HDMI to DVI adaptor), HDMI to VGA 
convertors are available but are generally 
expensive (Note: A passive HDMI/DVI to VGA 
adapter will not work. The Raspberry Pi does 
not generate the required analogue signals). 
The analogue RCA output can connect to 
older TVs, small screens, or video capture 
devices (approx. resolution is 640x480, 
enough for basic use). If both are attached, 


the Raspberry Pi defaults to HDMI. 


Internet Connection (optional) 

The easiest option is to use a RJ45 network 
cable direct to a router or modem, however 
with some additional setup it is possible to 
connect to your wifi network with a USB 
dongle. 


Audio Output (optional) 
The HDMI connection will transmit digital 
audio if connected to a TV, however if that is 
not available you can connect via _ the 
analogue audio plug. 

Article by Meltwater 


Basic Equipment 


. Micro USB Charger (rated at 5V 700mA 
minimum), plus micro USB cable if needed. 


. SD Card (2Gb up to SDHC 32Gb), plus 
suitable card reader. 


. HDMI Cable/Suitable cable for display 


4. Compatible Mouse/Keyboard 


. Powered USB Hub (required for high 
powered USB devices) 


. Network Cable and audio leads if required 


<= : Recommended HW see: http://elinux.org/RPi_VerifiedPeripherals 


HDTV Setup 


Power: Micro USB charger 
'B| SD Card: Standard size SD card 


HDMI: Connected to HD TV HDMI 
input for 1080p & digital audio 


'D| LAN: Wire connection to network 
hub /switch 


'E] USB: Wireless RF dongle for 
mouse and keyboard 


LCD Monitor Setup 
[A] Power : Micro USB Charger 


SD Card : Micro SD Card with 
Full Size Adapter 


HDMI : Connected to HDMI to DVI-D 
adaptor, then into monitor DVI 
input for 1080p (no audio) 


[D] LAN : Wired connection to network 
hub/ switch 


[E] USB : USB mouse and USB keyboard 


Audio : 3.5mm audio out to 
speakers/headphones 


Video Out Setup 


A} Power : Micro USB Charger / high capacity mobile battery 
(rated output at 5V 700mA or more) 


|B} SD Card : Micro SD card with full size adapter 


RCA Video : Connected to a TV AV In or SCART adaptor 
(European-TV connection) / USB video capture device 
'D] Audio : 3.5mm audio jack to phono for audio 
with video 


/E] USB : Bluetooth dongle to connect to 
Bluetooth keyboard / mouse, wifi dongle 
to connect to wireless network (probably 
powered by USB hub and additional 
setup required) # 6...2 ls | eu ea 


Pir / ol Hog 
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More information see the Wiki Pages: http://elinux.org/RPi_Hardware_basic_Setup 


Open up the Win32DiskImager program 


SD Card Setup 


Download your preferred Operating System (OS) you wish to 
run from the Raspberry Pi website: 
http://www.raspberrypi.org/downloads 


Fanner Goes na) a) Select the .img file 
oes | YOU extracted 
<)> "| previously by clicking 
on the small folder icon 
and browsing to where 
you extracted it. 


* The download page includes instructions for carrying out 
file corruption checks (using SHA-1 checksums), 
recommended to avoid problems. 

* Take note of the username and password related to the 
particular image you have selected. You will need this 
when you run it. 


b) Select the device 
letter which relates to 
your SD card. If in 
doubt double check 
this letter in Windows 
Explorer as the process © 
will remove all data on whatever drive you select. 


Se Wine? Disk Irager 


brep 
set 


| * SD card 2GB or larger (depending on OS and other 
requirements) 


sk | mmm) C) Click the Write 
* Suitable SD card reader (some built in card readers | 


se» button and you will see 
the program start to 

.. Write to the SD card. 
Note, you can also use 
Read to backup your 
SD card! 
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| 
| have issues so a USB card reader is recommended) 
| « PC running Linux/Windows or even a Raspberry Pi! 
(If using a Raspberry Pi use a powered USB hub with a 
| SD card reader to write the image to a new card. 
| Warning, it will be very slow this way!) | 


To see the result you 

can open up the Disk MD isaac cd endteine 
Management program — mame 

built into Windows. 


The following instructions apply to the 2013-02-09- 
wheezy-raspbian.zip file, but the steps should be 
similar whichever package is selected. 
Once you have written to your card, you are ready to boot 
your Raspberry Pi (see guide later on). 

a) Press Windows key + Rorselect Run... from 
To reinstall the Operating System or to select a different one, the Start Menu. 


simply repeat the process. 


SE BE eS Se oe Se ee ae EE eS RE et A ee Sea eh ee a ee eee = [Be Computer Manepement ere x} 
|NOTE: a 6S - 6 l Hie sction Yiew Help 
| «oe T° hi 
| Ensure the SD eee a | po 
|card write “Lock” + Uf Spter Toots 
‘is disabled! Writable Read Only ! 
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SD CARD SETUP WITH WINDOWS 


Extract the image file to your hard drive 

For ZIP Files: Explore using Windows and copy and paste 
contents out to your hard-drive. 

For tar/bz2 file, use PeaZip www.peazip.org. 


b) Type compmgmt .msc and press OK 


c) You will see the above window appear. Select the 
Disk Management component, then Storage and you 
should see your drives, including the SD card with 
several partitions (most likely 3): 

- boot: viewable in Windows 


You'll need at least 2GB of space to extract the file. You 
should end up with a .img file (this contains all the parts of the 
Operating System which needs to be written to the card). 


Write the image to the SD card 

You will need to use a program such as Win32Disklmager 
(available from http://www.raspberrypi.org/downloads). This 
program will write the image structure required for the 
Raspberry Pi to boot from the SD card. 


Insert your SD card into the card reader. Remove any other 
drives/devices you may currently have attached to avoid 
wiping the wrong device by mistake. 


- OS System: not viewable in Windows 

- OS Swap drive: also not viewable in Windows 

- ...lus any unallocated space at the end (see guide 
on resizing this). 


™ Disk 1 OO SS 
Removable (F) 

7.29 GB 75 Mi 

Online 


SD CARD SETUP WITH LINUX 


Note: These steps should apply to most common versions of Linux. 
Screenshots are from RacyPy (Puppy Linux, MagPi - issue 1) 


Extract the image file to your hard drive 

Locate your downloaded OS file in your file manager. 
Remember you'll need at least 2GB of space to extract 
the .img file. 


GUI programs such as XArchive (pre-installed on 
RacyPy) will allow you to locate and extract the .img file 
directly. 
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Alternatively use this 

command in a terminal 

window: 

unzip filename.zip 

The "filename.zip" should match the source file. 
Note, it will take a while to extract the files. 


Open a terminal window: 

You can normally open a terminal 

window directly from the file manager i.e. |» 
RacyPy/Puppy ROX-Filer right-click, 

select Window -> Terminal Here 

In Raspbian open the File Manager and press F4 


Identify your SD card device name 

Before you plug in your card reader and SD card take 
note of any devices you may have already plugged in or 
installed. You can usually see icons on the desktop, or 
run this command in a terminal window: 


Used Avail Uset Mounted on 
3.5M 121M 3% /initrd/pup_ry 
330M 0 100% /initrd/ant/dev_ro2 
265M 0 100K /initrd/pup_ro2 
2M 0 100% /initrd/pup_z 
3.5M 121M 3x / 

0 Sam 0% /dev/shn 
7.56 7.56 51% /ant/sdal 


WFilesusten 


Attach your SD card reader with the target SD card 
inserted. On RacyPy/Puppy you will see an extra USB 
icon has appeared (or browse through the file manager). 
Open it (this will "mount" it). 


Re-run df 


-h to 
confirm 


Used Avail Use% Mounted on 
121M) =3% /initrd/pup_rw 
0 100% /initrd/ant/dev_ro2 
0 100% /initrd/pup_ro2 
i) = /initrd/pup_z 


the new 
drive. 


In this case, we can see we have added drive "sdb". The 
partition "sdb1" is 3.8Gb and 32K is used. This matches 
what we expect to see for this SD card. 


that this is 


"Unmount" the partitions 


a] Run Pmount Puppy Drive Mounter 
@ kun Desktop Orive Icon Manager 
(if currently mounted) 


a] Unmount ALL mounted partitions 


You now need to "unmount" 
the device (this closes the 
drive so that the program is 
able to write to it). 

In RacyPy/Puppy you can 

right-click on the drive icon © Se" ‘ecaten 

and select "Unmount SAXY  «. gyccirop 

(if currently mounted)". oh Add Panel 

If you've used the card before, you may have multiple 
partitions, so ensure you "unmount" them all. 


ROX-Filer 
App dir ‘sdbl" 
Qf) Edit Item 


Alternatively use this command in a terminal window: 
umount /dev/sdb1i 
where sdb1 is the name of the device partition above. 


Write the image to the SD card 
Locate the directory which contains the extracted .img 
file and open a new terminal window. 


Write the image with the following command (where sdX 
should match your device name - without the number at 
the end). 

Take care on this step since this command will overwrite 
all the data on the drive - so ensure you get the right 
drive. 


M# sudo dd if=debian6-19-04-2012.ing of=/dev/sdb1 bs=1M 
1859+1 records in 
1859+1 records out 
a eageas bytes (2.0 GB) copied, 217.535 s, 9.0 MB/s 
+ 


sudo dd if=filename.img of=/dev/sdX bs=1M 


sudo - allow permissions to write to the SD card device 
dd - disk-to-disk program 

if — input file or source drive 

of —- output file or target drive 

bs — size of blocks to use during copy (1M is fine) 


lAdvanced Tip: You can also use dd to backup your SD card: 
Isudo dd if=/dev/sdX | \ 
Isplit -d -b 2000m - image.split 
| 10 restore the split image (splitting avoids oversized files): 
I sudo cat image.split* | dd of=/dev/sdX bs=1M 


Writing the image to the SD card will take some time 
(lookout for the card reader activity light flashing). Linux 
will report when the process has completed. 

Remove and re-insert the SD card to confirm there are 
now two new partitions visible on the card (sda1 Boot 
and sda2 Operating System). There is also a third 
hidden swap partition also. 


If you run into problems creating your SD card additional 
help and instructions are available on the Raspberry Pi 
Wiki (Mac instructions are also available). 
http://elinux.org/RPi_Easy SD Card_Setup 

If you have general problems, take a look at the trouble- 
shooting section. 

http://elinux.org/R-Pi_Troubleshooting 


Resize Partitions 


In order to maximise the use of an SD 
card, it is recommended the _ main 
partition of the card is enlarged to fill up 
the remaining unallocated space on the 
card. 


To do this, you will need a partition manage- 
ment program. The Linux program GParted is 
recommended as most software available for 
Windows cannot manipulate the Linux 
formatted partitions you now have on the SD 
card. If you don’t have Linux installed, you 
can use a LiveCD or VM (Virtual Machine), 
such as Puppy/RacyPy or Debian which were 
covered in The MagPi issue 1. 


There is even a specific GParted LiveCD, 
available with instructions on how to use it: 
http://gparted. sourceforge.net/livecd.php 


If GParted is not already installed on your 
Linux system, it can be installed with the 
following command in a terminal window: 


Ssudo apt-get install gparted 


Running GParted 


Start GParted from the application menu, (for 
Puppy/RacyPy it is located in the System 
section). 


Alternatively, you can start the program using 
the terminal prompt by typing: 


Ssudo gparted 


If prompted, enter your user password to give 
the program admin rights. 


When the GParted utility scans the drives and 
loads, click the dropdown box in the upper 
right hand corner and you should see an entry 
which matches your SD card. If you are un- 
sure, add/remove the card and rescan by 
pressing CTRL+R, or via the “GParted” menu/ 
“Refresh Devices” until you determine which 
one it is. 


Disclaimer: We are going to be altering disk 
partitions, so you MUST make sure you've 
selected the right disk (card in our case). If your 
screenshot differs vastly from that below, stop 
and ask yourself some stern questions before 
continuing. We are not responsible if you end up 
deleting your installed system. Remember 
always, you are running this as a super user. 
Please be careful. 


/dev/mmcbiko - GParted 
GParted Edit View Device Partition Help 


unallocated 
12.87 GiB 


Partition File System size Used Unused Flags 
/devimmcblkOp1 fi fat32 75.00 MiB 28.03 MiB 46.97 MiB Iba 
unallocated unallocated 1.00 MiB = _ 
/dev/mmcblkOp2 fj ext4 1.79 GiB 1,30 GiB 500.45 MiB 
/dev/mmcbikOp3 fi linux-swap 191.00 MiB 


LJ /dev/mmcbiko (14.92 GiB) ¢ 


unallocated unallocated 12.87 GiB 


You can now see the layout of your SD card. 
You should see 3 partitions in the top part of 
the window (Green, orange and blue in the 
above screenshot). We have a small boot 
partition, your 1.8GB home partition and a 
swap partition. What we need to do is to move 
that swap partition all the way to the right, and 
then stretch out the home partition to make it 
bigger. 


Move the swap partition. Right click on the 
third partition and choose Unmount/SwapOff. 
Then right click it again and choose 
Resize/Move. You'll see this screen: 


| 


Minimum size: 1 MiB Maximum size: 13371 MiB 


Free space preceding (MiB): 


New size (MiB): 191 
Free space following (MIB): 13180 
Align to: MiB 


Cancel 


In the Free space following (MiB) type 0 and 
press enter, or grab hold of the partition (at the 
top) with your left mouse button, and drag it all 
the way to the right: 

<)> 


Minimum size: 1 MiB Maximum size: 13371 MiB 
Free space preceding (MiB): {13180 

New size (MiB) 191 

Free space following (MiB) 0 


Align to: Ls MiB 


Cancel 1 Resize/Move 


Click Resize/Move. A warning will pop up 


stating that this may cause your operating 
system to fail to boot. Ignore this and click Ok. 


Stretch out the home partition. Right click on 
the second partition in the top of the window 
(the biggest partition), and again choose 
Unmount. Right click it again and choose 
Resize/Move. You'll see this screen: 


1} 


Minimum size: 1331 MiB Maximum size: 15012 MiB 
Free space preceding (MiB) 1} 

New size (MiB): k 1831 

Free space following (MiB): 13180 

Align to: MiB 


Cancel 


Grab the little arrow to the right of the partition 
with your left mouse button, and stretch it all 
the way to the right: 


—EEEEE 


Minimum size: 1331 MiB Maximum size: 15012 MiB 
Free space preceding (MiB): 1) 
New size (MiB): 15012 
Free space following (MiB): 0 


Align to: MiB 
Ls 


Cancel | Resize/Move 


Choose Resize/Move. 

Your screen should now be like this (please 
note that | have a 16GB SD card here, you 
may have one of a different size): 


/dev/mmcbiko - GParted k 


GParted Edit View Dev Partition Help 


ncblkO (14.92 GiB) } 


Idev; peli | = ET. 
| = ET. 


Partitio! FileSystem Mount Point = Size = ——-Used_~—sUnuses 
/dev/mmcblkOp1 {i Mi fat32 /media/95FS-OD7A 75.00 MiB 28.03 MiB 46.97 MiB Iba 
unallocated unallocated 1.00 MiB - _ 
/devimmcblkOp2 ff ext4 14.66 GiB 1.30GiB 13.36 GiB 
/devimmce bikOp3  linux-swap 191.00 MiB = = 


| Move /dev/mmcbikOp3 to the right 
>| Grow /dev/mmcblik0p2 from 1.79 GiB to 14.66 GiB 


Now we need to write the changes to the 
card. 

Open the Edit menu and choose Apply All 
Operations. You will now see a confirmation 
box. Click Apply. 


Wait for GParted to complete the operation 
(this may take a minute or two, depending on 


the speed of your SD card). When it's 
finished, click OK and the close GParted. 


You may now safely remove the SD card from 
your doner computer and put it back in your 
Raspberry Pi. Boot your Raspberry Pi and 
enjoy your new larger home partition! 


Article by Pete / Meltwater 


First Boot 

You have all your hardware, you've 
connected those wires (all except the power), 
you've prepared your SD card and you are 
ready to go. Remember, keep it simple and 
only connect the minimum hardware at first 
until you are happy everything is running 
smoothly (ideally the keyboard/mouse should 
be connected through a powered USB hub if 
available). 


Double check everything, switch on your 
display and now plug in the power! You 
should see the red PWR LED light up and 
within the count of 10 the OK light should start 
to flash activity. On your display you will see 
lots of text scrolling down the screen. This is 
the Raspberry Pi initialising. The first time it 
will take longer as it configures itself and 
resets. If you are using a TV and the text 
doesn't fit on the display, try changing the 
aspect ratio settings (i.e. widescreen, 16:9, 
4:3, etc) or if you still have issues check the 
wiki (http://elinux.org/R-Pi_ Troubleshooting). 


You should end up with a prompt similar to: 
Debian GNU/Linux 

raspberrypi login: 

You'll need to enter the username and 
password for the particular distribution you 
downloaded (for Raspbian, login with the user 
pi and password raspberry). 


Finally, to start a new graphical session type 
startx. To power down, select shutdown 
Jfrom the bottom right corner in the 
graphical session or type sudo shutdown 
—h now from the command terminal. 


If you have made it this far congratulations. 
The proof of the Pi really is in the eating. 


INTERFACING PROJECTS FOR BEGINNERS 
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If you feel your knowledge of electronics is rather 
limited, don’t despair. In this series we are not 
assuming that you have more than a basic 
understanding of electronics. The aim is to explain 
the basics and provide details of relatively simple 
hardware and basic software to get started. 


The Raspberry Pi provides an ideal way to begin 
experimenting. Not only does the low cost of the Pi 
mean that there is no need to worry about damage 
to an expensive computer, it also comes ready 
equipped with the 
connections to — get 
started right away. 


As you will have no doubt 
probably figured out 
already computers are all 
about In’s and Out’s. 
Input something on the 
keyboard or click with a 
mouse and get 
something out on the 
screen or sound out of¢ 
the speakers. Interfacing 
is simply finding other 
ways of getting 
information in to and out 
of the computer. 


The first thing to understand is that the basic 
building blocks of a computer are made up of 
millions of switches called transistors. Computers 
see everything as either on or off so when you 
click the mouse button the switch is on and when 
you let go it is off. The computer has no idea how 
hard the button has been pressed. This is Known 
as a digital binary system: when a switch is on it is 
represented by a ‘1’ (one) and when it is off a ‘0’ 
(zero). Signals that are variable such as 
measuring temperature are called analogue. As 


BY DARREN GRANT 


they are more complicated than just a simple on or 
off state, extra equipment is needed so the 
computer can read them. 


For now we will stick with a simple digital interface. 
The Raspberry Pi has a set of connections called 
the GPIO (General Purpose Input Output) ports. 
GENERAL PURPOSE means that they have not 
been assigned a specific purpose, unlike for 
example the speaker connection that has a well 
defined purpose. The connections on the GPIO 
port can be used for 
whatever purpose you 
like. Each connection 
can be used as an 
INPUT ~~ where _ the 
computer is waiting for 
an event to happen such 
as a_ switch being 
pressed or an OUTPUT 
where the computer is 
sending a signal out for 
example to switch a light 
or buzzer on and off. 


~The GPIO ports on the 
Raspberry Pi are low 


powered so an 
expansion board is 
recommended to 


provide higher powered signals that can be used 
for controlling things like lamps, buzzers and 
motors. A GPIO expansion board also provides 
some protection to the Raspberry Pi just in case 
something is connected incorrectly. 


Don’t worry if you don’t have a GPIO expansion 
board at this stage and you are raring to get going 
with your first experiment. Providing you take care 
we can start with a simple circuit using a switch 
and a LED (Light Emitting Diode). > 


Switch Types 


An electrical switch is used to _®@ = . 
make or break an_ electrical 

circuit. Switches are binary 

devices: they are — either 

completely on (closed) or completely off (open) 
making an ideal starting point for our interfacing 
experiments. There are many different types of 
switches, the simplest type being one where two 
electrical conductors are brought in contact with 
each other by manually moving a mechanism. 


» 


There are essentially two common types of switch, 
latching switches and momentary types. A latching 
switch stays open or closed when activated, for 
example a light switch; when you switch the light 
on or off the switch stays in the same position until 
you switch it again. A momentary switch on the 
other hand will only operate while pressure is 
being applied and will return to its previous state 
when released. Momentary switches can be found 
on a game controller where the control only 
responds while the button is being pressed. A 
momentary switch wouldn’t make a very good light 
switch as you wouldn’t want to have to keep the 
button pressed to keep the light on. The electrical 
symbol for a simple momentary push switch is 
this. 
oe 


EE ©) O—_—_—__ 
We will use a small momentary push button switch 


for this experiment, Known as a normally open 
tactile switch. 


LEDs 


LEDs (Light Emitting Diodes) can a 
be found everywhere, commonly sy f 
used as indicator lights on most 4 
electronic equipment such as 


the standby light on your TV. & 


Due to the small amount of 

power needed to make a LED light up, we can 
safely use them in our experiment without 
damaging the Raspberry Pi. 


The symbol for a LED looks like this. 
—F 

To save soldering wires together, a breadboard 
and a_ selection of jumper wires is_ highly 
recommended. It makes _ connecting things 
together very easy and flexible. The grid reference 
numbers are laid out on a small 270 point Tandy 
breadboard. If you have a bigger board that will 
work just as well but the reference numbers may 


not match so will need to be modified if your board 
has a slightly different grid layout. 


Place the components on the breadboard using 
the illustration as a guide. If your tactile switch has 
inward pointing legs like the one shown in the 
photo on the top left, use a small pair of pliers to 
straighten them. The switch needs to be inserted 
into the breadboard so that the legs are on the left 
and right edges. It is also important that the LED is 
connected the correct way round. The positive 
terminal called the anode is the longer leg and 
should be connected to point C4. Once all the 
components are in place connect the circuit to the 
Raspberry Pi using 3 female to male jumper wires, 
taking extra care to connect the correct terminals. 


The Raspberry Pi GPIO pins in the 
illustration are shown when 
looking at the board with 
the GPIO header in 
the top left corner, as 
shown in the photo 
in the Pi Dissection 
article on page 16. 


Having connected everything together, power up 
the Raspberry Pi and try pressing the button. The 
LED should light up. If it doesn’t work check that 
all the components and wires are connected 
correctly, paying particular attention to the LED. If 
the LED stays on without pressing the button then 
the switch is probably connected incorrectly and 
will need to be turned 90°. 


Continued over page... 


Pin 01 ZY x 1 ‘ 
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Circuit Description 


Because the Raspberry Pi GPIO port is not 
protected with a buffer, we have included a 1KQ 
(Ohm) resistor (R2) between the switch and the 
GPIO pin as a precaution to prevent damage if the 
GPIO port is accidentally set as an output. Our 
tactile switch is connected to the OV or ground line 
so that when it is pressed the circuit is completed 
between the GPIO pin and zero Volts. 


The LED along with a 4700 current limiting 
resistor (R1) is connected to the 3.3V positive rail. 
Pressing the switch completes the circuit between 
the LED and OV causing it to light up, this provides 
a visual indication when the switch is pressed. 
Finally we have a 10KQ pull-up resistor (R3). 


Digital Logic States 


As mentioned earlier, computers see the world as 
a series of zeros and ones. The Raspberry Pi uses 
3.3V CMOS logic meaning that a binary 1 is 
created by applying a voltage of 3.3V to an input. 


When the voltage is present it is referred to as a 
logic HIGH state. Alternatively when the GPIO pin 
is connected to OV a binary 0 or logic LOW state is 
created. In our switch example pressing the switch 
creates a LOW state by connecting the IO port to 
OV. > 
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SW1 - Tactile Switch J5, J8, Y5, Y8 
R3 - 10kQO Resistor D8, H8& 

R2 - 1kQ Resistor 11, 15 

R1 - 4700 Resistor D5, H5 

LED1 - Red LED C4, C5 

Wire link X4, B4 

Wire link X8, B8& 


Pin 06 
© ©6666 8666686 


©0080 8000008 
Pin 11 


Shopping List 


COMPONENTS 

1x 3mm Red LED (standard brightness) 
1x 4700 Resistor 

1x 1kQ Resistor 

1x 10kQ Resistor 

1x Miniature PCB Tactile Switch 


ACCESSORIES 

1x Breadboard 

3x Male-female jumper wires 

1x Selection of short jumper wires 


TOOLS 

If you don’t have them already then 
a set of small long nosed pliers for 
bending component leads and wire 
cutters will make construction easier. 


Digital logic in fact has three possible states 
known as Tri-State logic. We have already 
discussed HIGH (+3.3V) and LOW (OV) states but 
we also have a third state that is called 
FLOATING. Basically floating means the state is 
not clearly defined. Attempting to determine the 
status of a connection that is floating may result in 
unpredictable results. You might be thinking that if 
the pin is not connected to a voltage it must be 
low: the problem is we can not guarantee that we 
will get a reliable LOW signal by simply relying on 
the absence of a voltage on the pin. 


To illustrate the problem, imagine that we hold a 
piece of ribbon between two gate posts, the two 
gate posts would be connected by the ribbon. Now 
if we let one end of the ribbon go and allow it to fall 
to the ground the two posts are no _ longer 
connected. But what happens when the wind 
blows? The ribbon will flap around where 
sometimes it will be in contact with the ground and 
other times it will touch or even become entangled 
with the other post. To prevent the ribbon moving 
in the wind we would tie it either to the ground or 
the post so it wouldn’t move unless we wanted it 
to. We need to do the same thing with a logic 
circuit, to avoid unpredictable behaviour. We tie 
the connection to either 3.3V or OV using what is 
known as a pull-up or pull-down resistor that 
effectively creates a default state. In this 
experiment we have used a pull-up resistor so the 
lO port will always be connected to +3.3V making 
it the default state. In our example when reading 
the state of the IO pin it will always be high until we 
press the switch that will change it to low. 


Software 


Having completed the circuit construction we now 
have to get the Raspberry Pi to recognise the 
switch. To do this we need to create a software 
program that will instruct the Pi to monitor the 
switch status. 


We will be using the Python programming 
language to write our program. It is assumed that 
you are using the standard Raspbian operating 


system from the Raspberry Pi website. If you have 
not used Python before take a look at the guide to 
editing and running Python programs on page 24. 


The first thing we need to do is install a Python 
package that adds the capability to Python to 
control the GPIO pins on the Raspberry Pi. 
Download the Python package from 
http://pypi.python.org/pypi/RPi.GPIO the latest 
version at the time of writing this article is 
RPi.GPIO-0.5.0a. If the file version downloaded is 
different then the instructions below will need to be 
modified to use the version number you have 
downloaded. 


We will use the terminal to install the package, to 
open the terminal go to the main menu, select 
accessories and click on LXTerminal which will 
open a new window with a command prompt. The 
file is compressed and archived. To install it we 
will need to decompress and unarchive it by typing 
the following commands. 


We now have a new directory called RPi.GPIO- 
0.5.0a that we need to go into and run the setup 
script. Type the following commands to complete 
the installation. 


You may be asked for your password when 
running the install script. If you have not changed 
the password the default is ‘raspberry’. 


Now that the package installation is complete we 
can write a program to monitor the switch and 
write something to the screen each time it is 
pressed. Before we start programming, type the 
following command at the command prompt to 
return to the home directory. 


Continued over page... 
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Python v2.7 Program 


Create a new text file named mybutton.py and 
enter the following program. 


#!/usr/bin/python 
import time 

import RPi.GPIO as GPIO 
GPIO.setmode (GPIO.BOARD) 
GPIO.setup(1i1, GPIO.IN) 


while True: 
mybutton = GPIO.input (11) 

if mybutton == False: 
print "giggle" 
time.sleep(.2) 


Program Description 


We start by including the time and RPi.GPIO 
packages in our program so we can make use of 
their functions by using import. 


Next we configure GPIO pin 11 on the Raspberry 
Pi as an input so it can detect the switch. 


By using ‘while True’ we create a never ending 
loop so that everything below this will be repeated 
until we choose to stop it. 


Our program keeps checking the status of pin 11 
that will always be True (High) while the button is 
not being pressed. As soon as the button is 
pressed the GPIO pin goes low and our result will 
be False, at which point we print out the word 
“giggle” on the screen. Because the program runs 
much quicker than we can press and release the 
button we add a small 0.2 second delay before 
checking the button status again so that the 
screen does not fill up with giggles. 


www.tandyonline.co.uk 


To start the program type the following command 
into the terminal window. 


When you have had enough giggles press the 


Control+C keys to stop 
the program. 


fe J+(c) 


Counting 


Try the following program to count the number of 
times the button is pressed. 


#!/usr/bin/python 
import time 

import RPi.GPIO as GPIO 
GPIO.setmode (GPIO.BOARD) 
GPIO.setup(11, GPIO.IN) 
count = 0 


while True: 


mybutton = GPIO.input (11) 
if mybutton == False: 
count = counttl 


print "count", count 


time.sleep(.2) 
Conclusion 


We have covered how to make the computer 
respond to a switch circuit and written a simple 
program. Now that you have mastered the basics 
how about you try and improve the program. For 
example make a timer program that will start and 
stop counting when pressing the button. Why not 
send in your programs and questions to 
in.control@themagpi.com or get involved on the 
official Raspberry Pi forum. Maybe we can include 
some of them in the next instalment. @ 


This article is sponsored by Tandy. 

Look out for our new web site coming soon: where you will 
find all the components you need for your Raspberry Pi 
interfacing projects and much more. 


STOP THE PRESS! 
EACLUSIVE 
INTERVIEWS 


Do you have Raspberry Pi questions that you just can't find 
the answer to? 


Have you searched and searched the forum to no avail? 


Don't fret, the MagPi is here to help! 


We are pleased to announce that we are lucky enough to have an 
exclusive opportunity to interview both Eben and Liz, the King and 
Queen of the Raspberry Pi. 


If you have a question that you want us to put to those at the top of the 
Raspberry Pi Foundation, please contact us at editor@themagpi.com 
and look out for this exciting article in the near future in The MagPi. 
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Regulator) 


1 4V8 Pin 2 of RG1 (NCP117-1V8 Voltage | 
Regulator) used for SDRAM & CPU Core. 


DSI (Display Serial Interface) (S2) 
This will support direct connection to add-on screens 
(when available) 


SC Card Socket (S9) 
On power up, the Raspberry Pi will 
load the operating system directly 
from a suitably prepared SD card. 


Micro USB Power (S1) 
Only Pin 5 Ground and 
Pin 1 5V are connected 
(no data or ID) 


f PCB — Printed Circuit Board 
The components are connected through 
6-layers of tracks sandwiched together 
and connected through “vias” (holes 
through the board). One layer, called the | / 

“Ground Plane” (OV) is used to shield the || 5V In (TP1) 
densely packed signals, and separate SV supply after 
high-frequency data from sources of the 1A1 Polyfuse 
interference. | (F3 fitted on rear) 


i 2V5 Pin 5 of RG3 
(LP2980 Voltage 
used 


bssection J linc 


USB Gnd (TP2) 
Ground pin of Micro 
USB Power Supply 


woe ‘one! ta 


Raspberry Pi 


(C)2011 
o.2,°® 
O54 


cy TP 


i 
Cil 
1Ci2 


Regulator) 


ea 


*thhe 


' 
BOIRiIf: 


3V3 Pin 3 of RG2 
(NCP1117 Voltage 


| Tip: Engineers often use 3”V”"3 notation in electncal drawings (schematics) to indicate 3.3V or 1K2 (=1200) to ensure 


| the decimal point is clearly marked (mistaking 33¥ instead of 3.3V would be a big problem). 
! 


Composite Video Out & Analogue Audio 
Signals are generated internally by the SoC 
using on-board DAC (digital to analogue 
converter) for video and a smoothed PWM 
(pulse width modulation) signal for each right 
| and left audio channels. 


‘ LED Lights (D5-D9) 
Status OK (D5 Green) [BCM GPIO16] 
Power On (D6 Red) [3.3V Supply} 


Full Duplex (D7 Green) 
Link (D8 Green) 
100M (D9 Yellow) - 
100Mbps when lit! 


| 140mA Polyfuses (F1 & F2) | 
Limit the current drawn by 
USB devices. 


LAN (Local Area Network) Chip (1C3) 

The LAN9512 is connected via the SoC’s USB 
interface and provides 10/100Mbps wired LAN 
and dual USB connections. Model A of the 
Raspberry Pi, will have the SoC’s USB connec- 
tion connected directly to a single USB socket. 


Hynix 


256Mb SD-RAM - Wired directly on top of the | } 
Broadcom BCM2835 chip using PoP (Package on 
Package) method, this reduces the required footprint by 
avoiding 68 pin connections related PCB tracks. 


Under the RAM, is the Broadcom SoC (System on Chip), 
containing /700MHz 
(Gentral Processing Unit) and VideoCore I¥ GPU (Graphical 
Processing Unit). The SoC’s 300 pins are arranged in a grid 
(BGA - Ball Grid Array) allowing the physical size of the chip 
to be as small as possible. Each of the required pins are 
routed through one of the 6 PCB layers to the surrounding 
peripherals. 


ARM11 (ARM11/6JZF-S) CPU 


CSI-2 (Camera Serial Interface) (S5) 

This will allow connection to add-on camera modules (when 

available). The GPU is potentially able to handle up to 40MPixels 
stills and 1080p 30 fps (frames per second) video capture. 


4 The “wiggles” in tracks, ensure signals are matched 
electrically, reducing interference and signal delay. 


This is particularly important for high speed video 


| data and HDMI signals. 


Information based on Raspberry Pi 
Rev1 board and given as a guide. 
Compiled by Meltwater 
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SKUTTER 


ROBOT ic_ARM 
: 


WITH 
= 


= 
| 
<= PC INTERFACE 


a antl 
Build YOUr OWN Programmable Robotic arm 


Bodge N Hackitt has been unable 
to provide us with part 2 of his 
Skutter project this month, due to 
exams and family commitments. 
But he will be back! 


In the meantime, tzj has bravely 
taken up the challenge of making 
his own Skutter. He purchased the 
OWI robotic arm kit, and is going to 
share with us his experience of 
putting it together. So you can 
consider this article as 'Skutter 

Part 1.5’ 


The plastic airfix-like parts are a little tough to 
get through when clipping parts out, so adult 
supervision is advised. 


ss 


The nuts for the gear boxes are a bit of a 
fiddle to put in but so long as you have long 
nosed pliers, you should be ok. 


Wires at the motors are really hard to push 


into the clips. A thin flathead screwdriver 
does the trick. 


To make my assembly easier | also built the 
gripper gear assembly at the same time as the 
other gear assemblies. 


The base was fairly easy to assemble, though 
wire routing is a challenge in places. 


Note - 8V is taken from the middle (large) 
battery terminal. So | suggest you don't go out 
and get a 6 volt lantern battery to save money 
just yet, like | did. 


The software works but isn't optimised for 


larger screens. | had to download the 
64-bit software and driver for it to work. 


| had my next door neighbour's 4 year old 
son playing with the arm; once he got used 
to using it properly (rather than attempting 
to manually move it), he had a lot of fun. 
However, he did have better control over it 
using the mouse rather than the keyboard. 


After getting out my scales, the arm's 
weight with the batteries in is 1.155Kg, and 
the arm can lift 0.176Kg (the recommended 
weight is 0.1Kg), but it is unstable. The 
motors start to pull on the weighted side 
but nevertheless still hold. 


It may be useful as a helping hand, so long 
as it's angled in such a way that the weight 
is near the centre and the object isn't more 
than double the recommended weight. 


Some modifications to make it more stable 
under load may be required, so that it can 
perform better under those conditions. 


There is an extra disk you can buy which 
offers activities to do with the arm, but it's 
more money. 


Overall | really enjoyed building this part of 
the project, and | hope | helped others to 


have a go at building it too. 


Article by Chris "tzj" 
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Welcome to the Command Line 
Clinic. 


This is the first in a series of 
articles to help you to start using 
the command line _ interface of 
your Raspberry Pi. 


Your computer needs guidance. Without a 
human to tell it what to do, it will just sit there 
and sulk. You can click with your mouse, you 
can prod your finger on a screen, or you can 
type commands on a keyboard. These are all 
just ways to tell your computer what to do. 


The command line fills new users with dread. 
It can be very intimidating. Somebody who 
just clicks icons and buttons with a mouse will 
expect helpful messages and gentle feedback. 
A command line spits out gibberish and seldom 
reports that a command has been successful. 


So why do Linux users insist on using the 
command line? The funny thing is that Linux 
contains lots of fancy tools that you could use 
instead of the command line. So why is the 
command line so popular? 


First, the command line gives you the power to 
do anything you wish. A graphical tool will only 
support a common task that a lot of people will 
use. If you need to do something different, 
you may not be able to find a graphical tool to 
do the job. 


More importantly, you cannot assume that the 
correct graphical tool will be available when 
you need it. As an example, have you noticed 
that the standard Raspberry Pi Debian image 
has no tool to change the date and time? 
There are some tools available, but at the 
moment, these have not been made available 
for the Raspberry Pi. 


Therefore, if you want to set the date and 
time, you will need to use the command line. 
This is a good excuse for playing around with 
commands, because you can’t do much 
damage while messing with the date and time. 


So, let’s start messing with the command line. 
You can issue commands just after entering 
your username and password. Or if you prefer 
a graphical environment, you can select the 
desktop main menu item “Accessories” and 
then “LXTerminal”. 


Many users meet their first command line when trying out Linux. They wonder why 
no other operating systems have a command line. 


In fact almost every computer operating system has a command line. For example, you can 
enter commands into Windows by clicking on “Start” then “Run...” and entering the word “cmd”. 
On Mac OSX, press Command+Space and enter the word "terminal". 


Your iPhone, your iPad, your Android phone, your modem and your smart TV all have 
command line interfaces hidden somewhere. For somebody who wants to do something non- 
standard with their equipment, this command line is the gateway to unlimited access. 


Linux is just different because the command line is used more frequently (unlike in Windows) 


and not hidden completely (like in your iPad). 


If you want to see the current date and time, you should enter the command “date”. You should see 
something like 


$ date 
Fri Jun 1 09:49:25 BST 2012 


If you wish to change the date/time to June 21 13:45, you could use any of the following commands 
(whichever is more suitable for you) 


$ sudo date 06211345 
$ sudo date -s “June 21 13:45” 


$ sudo date -s “21 June 13:45 2012” 


$ sudo date -s “13:45 June 21” 
$ sudo date -s “Jun 21 1:45pm” 
$ sudo date -s “Next Thursday 13:45” 


Try experimenting with all the different options which can be used. See what happens when you enter an 
invalid date such as June 31st. 


PC. A Li 
his/her own files. To be able to change anything else, the user must add sudo to 
the beginning of the command. It is a way to ensure that you don’t do something 
silly unless you really want to. 


To see the difference, try entering the date command without sudo at the start. 
You will get an error “Operation not permitted”. 


If you are a bit nervous about the command line, this might be 
your favourite. It lets you escape to a nice graphical interface. 


startx 


free Show how much memory is available. 


dt / Show how much disk space is used. 


Show your IP address. Try this command with your network cable 
connected and disconnected to see the difference. 

Show what is plugged into the USB port. Try this command with 
your mouse connected and disconnected to see the difference. 


hostname -I 


Lsusb 
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COMPUTER 
MUSIC 


Interesting facts 


The first computer to sing a song was an 
IBM 7094 in 1961. The song was Daisy 
Bell (as in 'Daaaisy, Daaaisy, give me 
your answer, do’). 


The song was also used in the science 
fiction film 2001: A Space Odyssey. The 
intelligent computer Hal 9000 sings the 
song when he is being deactivated by 
Dave. The song was the first thing Hal 
learnt when he was programmed. 


If you or a family member own an Apple 
device with Siri, say to Siri "Sing a song 
to me" and see what it does. 


Back story 


It may surprise you to learn that most modern 
pop music involves the use of one or more 
computers in its creation. Styles like Hip Hop, 
Drum & Bass, House, Trance and Dub Step 
rely heavily on the use of computers. The 
basic idea is that the computer is 
programmed to play sound effects in a certain 
sequence or pattern which becomes a song. 
The sound effects can be anything from a 
drum beat to someone singing. So when you 
press play, the computer itself performs the 
music as opposed to a band. 


The technique is called sequencing. The user 
will need to have an ear for music though as a 
bad sequence can sound like a cat's choir. 
The computer will simply play whatever it's 
been told to play, nothing more. You could go 
out and spend a lot of money on professional 
music equipment to do this, or you could just 
download free software and do it on your 
Raspberry Pi for nothing! 


What software to use? 

You'll encounter a lot of 'my program is better 
than your program’ arguments when you get 
into making music on computers. My advice is 
not to limit yourself to any one program, try 
them all. You may find you are limited to what 
is available for the Raspberry Pi to start with, 
but in time this will improve. The program we 
are going to use in this tutorial is by no means 
the best program in existance, but it is a good 
place to start. 


The program we are going to use is a tracker 
program. This is a lightweight program that 
does what | described above. You load sound 
effects, called samples, into the program and 
then you program these sound effects into 
pages of music, called patterns, which 
represent the sequence. 


To get an idea of the level of music that can 
be achieved, we're going to get the program 
running and use it to play back a few songs. 
Playing back other people's stuff is good fun, 
I've spent hours doing it before. It will give you 
a lot of cool ideas and will hopefully spark 
your imagination. 


Introducing Schism Tracker 


The program we're going to use is called 
Schism Tracker. 


If you are using the recommended Raspbian 
distribution, there are two ways you can get 
Schism. The first way is to open a command 
window and enter the following: 


$ sudo apt-get install schism 


The second way is to download Schism from 
the Pi Store. 


Schism Tracker 

Schism Tracker is a free 
reimplementation of Impulse Tracker, a 
program used to create high quality 
music without the... 


RRR 


Free! 


Open / Download 


If you used the apt-get method to install 
Schism, you will find it in the Application 
Menu, inside the Other category. 


® python (v3.2) 


“ 
Accessories b Schism Tracker Font Editor 
& Education >| @ sh 
2) Electronics >» © Stable version of Scribus 
# Graphics > ® Synaptic Package Manager 
© Internet > Telsh8.5 

- Office b Telnet 
™ “The GIMP 
®@ Programming r TkWish8.5 
System Tools > Top 
@ wpa_supplicant user interface 
Preferences a rae 
be Xarchiver 
AUR Xev 
© Logout xfontsel 
A= Oe Xkill : 


Schism Tracker will start inside a command 
window. Note: avoid maximising the window 
as this will make Schism Tracker run slowly. 


If things are working correctly you should see 
an image similar to the one below. 


Press Enter to continue. Don't be fooled by 
the old-school look and feel of this program. It 
is fast, convenient and has survived so long 
for good reasons. 


In the world of tracker programs a song file is 
called a module. To download module files, 
visit http://modarchive.org where there are 
hundreds of songs. Use the menu at the top of 
their site to go to Music... > Charts > Top 
Favourites - | recommend you listen to the 
first 20 or so in that list. 


[Ed: To search for specific songs go to 
Music... > Browse by... > Searching. Some of 


my favourites are Unreal, Space Debris, 


Dead Lock, Catch That Goblin, Klisje Paa 


Klisje, Aces-High2, Kefmania, Funk It Up, 
Knulla-Kuk and S.C.Out). 
files 


The modarchive.org 


come in a 


compressed zip file, so they need to be 
extracted before you can play them in Schism. 


First create a folder in your Home folder called 
schism. Download some songs. By default 
these will appear in your Home folder. Right 
click each zip file > Extract To... and select the 
schism folder in your Home folder. 


In Schism Tracker, press F9 to load a module. 
You should see an image like the one shown 
below. 


a sehism jracker 


The right portion of the screen is a folder 
browser to load module files, you'll need to 
navigate into the schism folder. You can either 
use the mouse to double click it or use the 
cursor keys to move the selection and press 
Enter. 


A list of module files will display on the left 
portion of the screen. Double click one or use 
the cursor keys and press Enter to load. 


Press F5 to play the song. F8 to stop 
playback. Press F9 again at any time to load a 
different module, and F5 again to play it. 


Play from 
Pattern 


mark or : 
Load Song Order List 


Help Sample List PlaySong currentrow 


V ‘ a || V A v y if f | 


Pattern Editor 


Play current : ‘ 
y Save Song 
pattern 

Instrument List Stop playback 


(Advanced) 


Song variables 
and folder 
settings 


This is all we're going to do for this tutorial. In 
the mean time, just have some fun listening to 
other people's work. 


Article by Dave Spice 
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a <> In issue 1 we showed you how to set 
| debia Nn 7 up an Oracle VM VirtualBox of the 
Linux Debian Operating System... 


Following on from last time, we thought we would show you how to write and run Python programs 
using your VirtualBox, and a few simple file and folder operations. 


Editing And Running Python Programs 


1. Open Leafpad by clicking on the start button and 


4. Save the program as ‘hello. py’. 
navigate to Accessories > Leafpad. Eee PY 


Save As 


Name: |hello.py| 


Save in folder: | 4 user 


G File Manager 


a . > B for other fold 
# Graphics > HB Image Viewer Sensi bee ee 
© internet > @ Lderminal Character Coding: | Current Locale (UTF-8) ¢ | uF S| 
> ale : fi | © cancel f Easeve ] 
> @ Root Terminé simple text editor : : 
% Sound & Video > Be Xarchiver (Bsave as 
» System Tools } a 
5. Open LXTerminal by clicking on the start button and 
Preferences navigate to Accessories > LXTerminal. 


Run | 
ees es @ File Manager 


@ Graphics >| HE image Viewer 
@ Internet >= val [S 
® office >| @ Leafpad |Use the command line 


Logout 


other > G Root Terminal 
2. Let's type a simple Python program into Leafpad: § Sound & Video >| Be Xarchiver 


print "Hello" & System Tools > 
Preferences > 
*(Untitled) Riri 
File Edit Search Options Help Logout 


print “Hello” 


| | Bhello.py 


6. In the LXTerminal type 'Is' and press enter to see the 
list of files in your Home directory. You can think of the 
Home directory as being the Linux version of 'My 


ee ~ 2 = , ; — Documents’. You should see a directory called 
- BL = (Gruntitled) ‘Desktop’ and also your saved hello.py file. 


3. Click File>Save As... from the pulldown menu 


@ hello. py user@debian: = 
File Edit Search | File Edit Tabs Help 
print "Hello" | aera 


*(Untitled) 
"eile | Edit Search Options Help 


r@debian: _ 

« New Ctrl+N 

<) Open... ctrl+o 

[|] Save Ctrl+S 

A - @ Swe | Ml user@debian: ~ 

+ Print Preview Shift+cCtrl+P iB roloy EL vescmsebion 
| Print... Ctrl+P 
NOTE: The Debian LiveCD comes with Python 
| Quit ctri+Q version 2.6.6. You can confirm this at the 

— LXTerminal prompt by typing ‘python -V' (Make 

: a my « (Fr untitled) sure that is a capital V not lower case v). 


24 


7. Type in ‘python hello.py' and press enter to run your 
Python program. You should see the word ‘Hello’ 
printed on the line below. 


@ hello. py 
File Edit 
print "Hello"| 


Search Options Help 
; user@debian: ~ 


File Edit Tabs Help 


user@debian: 
h . 


» Py thon hello »Py 


Px 


8. You might like to make a directory / folder to keep 
your Python programs separate from other files. Type: 
‘mkdir python’. Then type 'Is' to check that the new 
directory is there. 


hello. py 


pf File Edit Tabs Help 
user@debian:~¢ Ls 
Desktop hello.p) 
user@debian:~$ python hello.py 
Hello 
user@debian:~$ mkdir 
~$ Ls 
Desktop hello.py 
user@debian: ~$ 


) 
~ 


python 


python 


9. Close Leafpad by clicking the X in the top right 
corner. Then in the LXTerminal type: 'mv *.py python’. 
Then type 'Is' - you should see that the 'hello.py’ file has 
gone. 


File Edit Tabs 
Hello 
user@debian:~$ mkdir python 
adebian:~$ ls 
Desktop hello.py 
r@debian:~$ mv 
user@debian:~$ Ls 
SDesktop python 
user@debian:~$ ii 


Help 


use 
python 


*.py python 


r user@debian: ~ - 


‘mv *.py python’ - means move all files that end with 
‘py’ into the directory called ‘python’. 


10. Type 'cd python’ and then 'Is' to change directory to 
‘python’ and list the files. Make sure that hello.py got 
moved into the ‘python’ directory. 


user@debian: ~/python 


File Edit Tabs Help 


Deskto 
user@debian:- 


| Hl User@debian: ~... 
11. Type 'cd ..' to move up one directory level (Back to 
the Home directory). Type 'Is' again to check where you 
are. You should see Desktop and python directories. 


user@debian: ~ 


File Edit 
python 
@debian: 


Tabs Help 


De python 


user@debian: ~$ 


12. To remove the python directory (delete it) type in 'rm 
python -R'. Then type 'Is' to see that the python 
directory is gone. The '-R' means recursive - deletes 
any files or directories that are inside the python 
directory as well. 


user@debian: ~ 


File Edit Tabs 


Help 


p python 
bian:~$ rm python -R 
plan: ~$ ls 


user@debian:~$ ff 


“a user@debian: ~ — 


13. To close the LXTerminal type ‘exit’. 


Desktop python 

¢ rm python -R 
user@debian:~$ ls 
Desktop 

. user@debian:~¢ exit 


user@debian: 


= user@debian: ~ |_| 
Well done! Look out for more next month. 


Article by Jaseman 
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We should start by opening a window that is suited to displaying graphical output, rather than just 
the very simple text output that you get from the terminal or command line: 


# OPEN A PYGAME GRAPHICS WINDOW bd 
r ] # By Jaseman - 03 May 2012 gS 
import os, pygame 
e from pygame.locals import * e 
@ = Pygame. init() a 
clock = pygame.time.Clock() 
® os.environ['SDL VIDEO WINDOW POS'] = 'center' ® 
e # This title appears along the top of the graphics window 2 
pygame.display.set caption("The Title Of My Program") 
® # Opens a graphics window called 'screen' with width 400 height 200 ® 
Fe) screen = pygame.display.set mode([400,200],0,32) &S 
pygame .time.wait(5000) # A 5 second pause before ending the program 
= = 


Try changing the width and height from PYTHON VERSION: 3.2.2 ay 


400x200 and run the program again to see my, 


iharesulis: PYGAME VERSION: 1.9.2a0 a4 4 We ated 


0.S.: Win7 Vv 


When you run this program you should see a black rectangular window appear with a title along 
the top. All of the pygame graphics will be drawn inside this window. When deciding what size the 
graphics window should be, consider that some people that use your program might have smaller 
monitor screens or televisions than you. If you make the window too big, the edges may not be 
visible on small screens. You also need to think about what your program will be displaying. This 
will help in deciding the best shape and size for your graphics window. 


This time we 


have added some surface fill commands to paint the entire screen surface in colour. 


The colour values are defined in amounts of Red, Green and Blue -- we call these RGB colour 


values. 


# DISCO SCREEN 


import 


pygame. 


screen 

screen. 
screen 
screen. 
screen. 
screen. 
screen. 


screen. 


screen. 


# By Jaseman - 10th May 2012 


from pygame.locals import *; pygame.init() 


clock = 


os.environ['SDL VIDEO WINDOW POS'] = 'center' 


-£111((255,255,0));pygame.display.update();pygame.time.wait (2000) 


os ,pygame 


pygame.time.Clock() 


display.set_caption("Disco Screen") 
= pygame.display.set mode([400,200],0,32) 


£111((255,0,0) ) ;pygame.display .update() ;pygame.time.wait(2000) 


£111((0,255,0) ) ;pygame.display.update() ;pygame.time.wait(2000) 
£i111((0,0,255) ) ;pygame.display .update() ;pygame.time.wait(2000) 
£111((0,255,255) );pygame.display.update();pygame.time.wait(2000) 


£111((255,0,255) );pygame.display.update();pygame.time.wait(2000) 


£111( (255,255,255) );pygame.display.update();pygame.time.wait (2000) 


£111((0,0,0) );pygame.display.update();pygame.time.wait (2000) 


The amount of Red, Green or Blue can be 


any number between 0 and 255 - 0 being PYTHON edie oa 
very dark and 255 being very bright. caress 1.9.2a0 
.S.: Win 


Try experimenting with different amounts of 
Red, Green and Blue. 


You can visit this website which will make it (Weel Gouna 
easier to find the right RGB values for the 
colour you are looking for: 
http://www.colorpicker.com 


Move the dot around within the shaded 
square and drag the arrows to the right up 
and down. When you find a colour you like, 
note down the R: G: and B: numbers that 
are listed to the right hand side. You can 
ignore the H: S: and B: ones. 


Continued over the page... 
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In this example we draw some basic geometric shapes onto the screen - a circle, a rectangle, a 
triangle (polygon) and a line. 


# GEOMETRIC SHAPES 

# By Jaseman - 10th May 2012 

import os,pygame 

from pygame.locals import *; pygame.init() 

clock = pygame.time.Clock() 

os.environ['SDL VIDEO WINDOW POS'] = 'center' 

pygame.display.set caption("Geometric Shapes") 

screen = pygame.display.set_mode([400,200] ,0,32) 

# Draw a CIRCLE on screen in (red) at (x,y) coords (60,70) of diameter 40 
pygame.draw.circle(screen, (255,0,0),(60,70) ,40) 

pygame .display.update() ;pygame.time.wait (2000) 

# Draw a RECTANGLE on the screen in (yellow) at (x,y,width,height) 
pygame.draw.rect (screen, (255,255,0),(70,70,120,60) ) 
pygame.display.update();pygame.time.wait (2000) 

# Draw a POLYGON on the screen in (green) at points ((x,y),(X,Yy),(X,Y)) 
pygame.draw.polygon(screen, (0,255,0),((120,100) , (240,40) , (220,130) ) ) 
pygame.display.update();pygame.time.wait (2000) 

# Draw a LINE on the screen in (blue) from (x,y),(x,y),width 


pygame .draw.line(screen, (0,0,255),(10,150) , (370,30) ,10) 


pygame.display.update();pygame.time.wait(10000) 


To really get to grips with these new 


commands, try adding more circles, PYTHON VERSION eee «ED: 
lines, rectangles and polygons. Change PYGAME VERSION: 1.9.2a0 ae oy * 
0.S.: Win7 TT ¥ 


the coordinates and RGB values and see 
if you can draw a picture. 


Notice how the later shapes are drawn on top of the earlier 
the ones. Each shape is drawn in the order that it is listed. 


al python The polygons don't have to be triangles - you can add as many 


° x,y points as you like. 


This simple house picture is created using some of the pygame draw commands: 


# THE HOUSE 
# By OtheOjudgeO - 29th May 2012 


import os, pygame; from pygame.locals import * 
pygame.init(); clock = pygame.time.Clock() 


os.environ['SDL_ VIDEO WINDOW _POS'] = 'center' 


d = pygame.draw # this will save us writing 'pygame.draw' many times 


pygame.display.set_ caption("The House") 


# Define some colors 

white = (255,255,255); black = (0,0,0) 

bg = (186, 213, 48); walls = (157, 109, 9) 

door = (151, 36, 9); door light =(181, 132, 14) 


# coordinates of glass panes 
windows = [(82, 125), (82, 215), (262, 125), (262, 215)] 


#init screen 
screen = pygame.display.set mode([423,347],0,32) 


#the walls 

screen.fill(bg) #£i11 the background screen colour 
d.rect(screen, black, (60, 102, 305, 225) ) 
d.rect(screen, walls, (73, 114, 280, 200) ) 


#the roof 

d.polygon(screen,black, ((35,112),(121,12),(296,12),(321, 36),(321, 
(361, 12),(361, 84),(384, 112))) 
d.polygon(screen,walls, ((62,101) ,(128,23), (289,23) ,(334, 69),(334, 
(348, 25),(348, 88),(361, 101))) 


#the door 

d.rect(screen, black, (167, 198, 84, 125 )) 
d.rect(screen, door, (179, 210, 60, 101 )) 
d.rect(screen, black, (185, 216, 50, 54 )) 
d.rect(screen, door light, (191, 222, 38, 41 )) 
d.circle(screen, black, (209,277) ,5) 


#the windows 

for window in windows: 
d.rect(screen, black, (window[0], window[1], 76, 76) ) 
d.rect(screen, white, (window[0] + 
d.rect(screen, white, (window[0] + 
d.rect(screen, white, (window[0] + 
d.rect(screen, white, (window[0] + 

#let's see the end result 

pygame.display.update() 

pygame.time.wait (10000) 


pygame.quit() ) 


PYTHON VERSION: 3.2.2 
PYGAME VERSION: 1.9.2a0 
0.S.: Win7 


12), 


25), 


12, window[1] + 12, 22, 22) ) #tl 
42, window[1] + 12, 22,22) ) #tr 
12, window[1] + 42, 22, 22) ) #bl 
42, window[1] + 42, 22,22) ) #br 


1b 


{ 
te 
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Nice concept, nice layout, nice 
graphics, nice mag overall. 
Dave G2 


Looks great, congrats. | can't wait 
for the next one. 
kirbyman62 


Hey, | love the design of the mag 


— very pro. 
pifan 


Just had a scan through the 
MagPi. It looks really good; 
seems like a great deal of 
thought and effort has gone into 
it 

budgieboy 


Really like what you did for a first 
issue! 
Rek 


Excellent! | enjoyed reading it 
Now just waiting to hear from 
in South Africa when | cant 
from the 


Very attractive, 
it so 
impression 


Ji 


cinating. VERY well done. 


fe 


Absolutely 
better than I! expected. In 
particular the Python Pit is just 
what beginners need. 

bredman 
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Hi there, congrats with your Til 


issue — well done! 


What a terrible site. Sorry. 
| finally manage to get the 
and read it in xpadf it's OK, b 


rather primitive. 


| quickly read thought it an 
pleasantly surprised. lis 
out, hits the target markets ( 
child friendly areas for coding, 
and has some nice content. 


Thanks very much for providing 
this mag. I'm very much looking 
forward to further issues and to 


see how it develops. 


a good 


feh_orph trikidiki 


Gordont 


around the 


JoeDaStudd 


done something 
e. I'm 15 and | must 
say | buy magazines for a fiver 
with less engrossing content than 
Forrrge this. | found every article 
interesting, and after showing my 

friends they too had a great read. 

FullXion 


Kudos on the first issue. Very well 
put together for a first issue, and 
im sure if the momentum keeps 
going there will be some 
interesting stuff in there as you 
cover peoples projects and 
suchlike. 

ArborealSeer 


While | didn't learn anything 
groundbreaking (I'm a software 
developer) | did learn a few new 
things about Linux and think the 
coding tutorials are pitched at the 
perfect level for a beginner! Well 
done guys! 

Tavalin 


Image from photofunia.com 
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Raspberry Pi is a trademark of the Raspberry Pi Foundation. The MagPi magazine is collaboratively produced by an 
independent group of Raspberry Pi owners, and is not affiliated in any way with the Raspberry Pi Foundation. The 
Magpi does not accept ownership or responsibility for the content or opinions expressed in any of the articles included 
in this issue. All articles are checked and tested before the release deadline is met but some faults may remain. The 
reader is responsible for all consequences, both to software and hardware, following the implementation of any of the 
advice or code printed. The MagPi does not claim to own any copyright licenses and all content of the articles are 
submitted with the responsibility lying with that of the article writer. 
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http:/Awww.themagpi.com 
Official website of The MagPi magazine. 
Tandy have generously 


provided The MagPi with http:/Awww.raspberrypi.org 
a Domain name. Official home of the Raspberry Pi Foundation. 


http://www.raspberrypi-spy.co.uk 
Raspberry Pi resources, tutorials, help and downloads. 


A great big "THANK 
YOU' from The MagPi 


Team. http://www.raspberrypiusers.com 
A Raspberry Pi website/blog. 


http://scratch.mit.edu 
Official Scratch website. 


http://www .linuxuser.co.uk/tutorials/how-to-set-up-raspberry-pi 
Liam Fraser's article on setting up your Raspberry Pi (SD cards). 


http://www.designspark.com/theme/raspberrypi 
editor@themagpi.com RS Components online resources and design support for Engineers. 
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